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PREFACE 



Thfs manual provides operating in- 
structions for the Monitor program 
provided for the AMC 95/4000 series 
MonoBoard Computers; it is intended to 
assist the system designer in develop- 
ing programs for the MonoBoard Com- 
puter. Familiarity with the MonoBoard 
architecture and the serial I/O inter- 
face is assumed. 



The information in this publication is 
believed to be accurate in all re- 
spects. However, no responsibility is 



assumed for errors that might appear 
in this publication. Advanced Micro 
Computers disclaims responsibility for 
any consequences resulting from the 
use thereof. No part of this manual 
may be copied or reproduced in any 
form without prior written permission 
from AMC. 

This product is intended for use only 
as described in this document. Ad- 
vanced Micro Computers cannot be re- 
sponsible for the proper functioning 
of undescribed features or parameters. 
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MONOBOARD MONITOR 



1-1. INTRODUCTION 

The MonoBoard Monitor provides a basic 
program development tool for the Mono- 
Board computer board. The Monitor pro- 
vides the following via keyboard/CRT 
command: 

o memory inspection and modification 
o program load, execute, and break- 
point debug 
o program save/load via papertape 
o data save/load via papertape 



When the MonoBoard 
ated at power-on, 
message followed by 
(<) is displayed, 
waits for a command 
Commands are specif 
phabetic characters 
more parameters and 



Monitor is initi- 
an identification 
a prompt character 
The Monitor then 
via the keyboard, 
ied by single al- 
fol lowed by one or 
a carriage return. 



The Monitor uses a terminal connected 
to the serial I/O port. See the AMC 
MonoBoard Computer User's Manual for 
detailed information about CRT/TTY 
connections and optional jumper con- 
nections on the MonoBoard Computer 
boards. 

When power is applied to the Mono- 
Board, the Monitor program begins 
execution at address zero and the 
prompt 

AMC MONOBOARD MONITOR 
> 



is displayed 
device. 



on the terminal output 



1-3. MONITOR COMMANDS 



1-2. INSTALLATION 

The MonoBoard Monitor is supplied on a 
single 2716 E-PROM. To install the 
Monitor, insert the E-PROM into the 
MonoBoard memory socket for address 
zero. 

As shown in figure 1-1, the Monitor 
resides in the PROM area from address 
0000H through 07FFH. Addresses 0800H 
through 2FFFH are ROM location avail- 
able to the user. The Monitor working 
space occupies addresses 3C00H through 
3CC3H; all other RAM locations are 
available to the user. 

The standard configuration does not 
contain memory from location 4000H, 
through FFFFH. Any references to 
non-existent memory will cause unpre- 
dictable results. 



Command mode directives are specified 
with a single alphabetic character 
following the Monitor prompt (>). 
These directives can be followed by 
hexadecimal arguments as described be- 
low. These arguments are separated by 
one or more of the following charac- 
ters: 

blank !"#$%&'()*+,-. / 

Arguments enclosed in ( ) are optional 
and need not be included. 

When a command is not recognized by 
the Monitor or the command arguments 
do not conform to the required format, 
the Monitor responds with a question 
mark (?). (See table 1-1 for Monitor 
Command Summary.) 

The RUBOUT key on a TTY or the DEL key 
on a CRT terminal can be used to erase 
the current character in a line. 
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3FFF 
3CC4 
3CC3 

3CBA 
3CB9 



3C10 

3C0F 
OE 
OD 
OC 
OB 
OA 
09 
08 
07 
06 
05 
04 
03 
02 
01 

3C00 



3000 
2FFF 



0800 
07FF 



0000 



user stack area 
(10 bytes) 



Return Address-high 
Return Address-low 



Stack Pointer-high 
Stack Pointer-low 



PSW-High 
PSW-Low 



H register 



L regi 



D reg 
E_re£ 



B register 
C register 



ster 



ster 
ster 



2 bytes 



2 bytes 



User RAM 



Monitor Variables 



Return Address 

Stack pointer pair 

Program status word pair 

Register pair 

Register pair 

Register pair 

Monitor Variables 

optional parameter 
for the "X" command 

User RAM 
User ROM 



MonoBoard Monitor 



Figure 1-1. Monitor Memory Map. 
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TABLE 1-1. MONITOR COMMAND SUMMARY. 



Command 


Function 


C X,Y 


COMPARE memory strings at X and Y 


D X(,Y) 


DISPLAY memory from X through Y 


F X,Y,Z 


FILL memory from X through Y with Z 


G (X) (B=BBCC) (D=DDEE) 
(H=HHLL) (P=AAFF) 
(S=SSSS) (;Y) 


"GO", substituting register values as 
specified, with breakpoint at Y (if 
specified) 


M X,Y,Z 


MOVE memory string from X through Y to 
location Z and following 


R (X) 


READ hex tape with optional X bias load 
address 


S X,Y1,Y2,...YN 


SUBSTITUTE into memory starting at X, the 
Y values as specified. Eacy Y value spe- 
cifies one byte. 


T (same parameters as 
G above) 


TRACE and dump registers at breakpoint 


W X,Y 


WRITE hex tape from X through Y 


X X(,Y) 


EXECUTE program at location X and store 
the value Y at top of Monitor RAM 


Parameters enclosed in parentheses are optional. Comma means 
any acceptable separator. 


Note: Semicolon shown ir 
with the parameter. 


1 the G and T commands must be entered 
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The CTRL and the Q keys are used to- 
gether (Control-Q) at any time to can- 
cel a keyboard entry or terminate any 
operation. 

In the following command format de- 
scriptions and examples, commas and 
blanks are used as argument separa- 
tors; however, any of the previously 
listed separators may be used as de- 
sired. 



Compare Memory C, XXXX, YYYY 



This command compares the two memory 
ranges starting at locations XXXX and 
YYYY. It returns the first locations 
for which a difference is detected, 
followed by the contents of each. The 
compare terminates if either range 
reaches location FFFF without a mis- 
match. 

Examples: 

>C 3000, 3CC4 
3200 23 3EC4 27 



Display Memory D, XXXX, YYYY 



This command displays the contents of 
memory from locations XXXX through 
YYYY. When YYYY is not specified, the 
contents of memory at location XXXX 
are displayed. If XXXX is greater 
than YYYY, the display will wrap- 
around to location following the 
display of location FFFF. 

Examples: 

>D 0818,0824 

6618 34 8A 68 C9 00 21 55 DC 4B 7D 
32 57 DC 

>D 100 
0100 48 



Fill Memory F, XXXX, YYYY, ZZ 



memory locations XXXX through YYYY 
with the value ZZ. Both XXXX and YYYY 
parameters must be supplied. If XXXX 
is greater than YYYY, the fill will 
wrap-around to location after fill- 
ing location FFFF. 

Examples: 

>F 3000, 3100, FF 

(The value FF is written into loca- 
tions 3000 through 3100.) 



Go to User Program, and Substitute 
Values for Program Registers 

G (XXXX) (B=BBCC) (D=DDEE) (H=HHLL) 
(P=AAFF) (S=SSSS) (;YYYY) 



This command starts or resumes execu- 
tion of user code. If an address XXXX 
is specified, execution starts there. 



Otherwise execution 
address following the 
A breakpoint address 
using the G command 
semicolon followed by 
which specifies the 
dress, 
be set 



resumes at the 

last breakpoint. 

can be selected 

by entering a 

an address YYYY 

breakpoint ad- 

The breakpoint address cannot 

to a ROM location. Also, 



This command fills the contents of 



breakpoint is good for only one break. 
Registers are assigned values as 
pairs. The substitution must be 
specified with a pair name as follows: 

B B,C registers; 

D D,E registers; 

H H,L registers; 

P A register and flags; 

S Stack Pointer. 

The pair name must be immediately fol- 
lowed by the = replacement operator. 

When no substitution is specified for 
a pair, these registers retain their 
last contents. User code execution is 
suspended by an escape during 1/0. The 
Monitor will also breakpoint a program 
when an RST 3 or RST 5 instruction is 
encountered during execution. 
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Examples: 

>G 

(resumes execution of user code from 
point last suspended, with old regis- 
ter values) 

>G 1000 

(starts execution of user code at 1000 
with old register values) 

>G S=3CD0, D=20 

(resumes execution of user code from 
point last suspended, but with stack 
at 3CD0 and reg D=0 and reg E=20) 

>G 2400 H=4200 



(starts execution at 2400 with 
gister H=42 and register L=00) 



re- 



Move Contents of Memory 
M,XXXX,YYYY,ZZZZ 



This command copies the contents of 
memory at locations XXXX through YYYY 
into the memory, starting at location 
ZZZZ. The source range must be speci- 
fied with XXXX less than or equal to 
YYYY. 

Examples: 

>M 100,120,6550 
>M,423C,423F,4000 



Read Hexadecimal Paper Tape 
R (XXXX) 



This command reads a hexadecimal for- 
matted paper tape (prepared using the 
W command) into memory. The tape is 
read from the TTY tape reader. It is 
loaded into memory at locations speci- 
fied in the records on the tape. When 
a bias, XXXX, is specified, the desti- 
nation location is computed from the 
(2's complement) sum of the bias and 
the record addresses. Each tape ends 
with an end-of-file (null) record. 



Examples: 

>R 

(reads in tape to the memory locations 
specified by the tape records) 

>R 100 

(reads in paper tape into memory at 
locations 100 greater than those 
specified by the tape records) 

>R FF00 

(reads in paper tape into memory at 
locations 100 less than those 
specified by the tape records) 



Substitute Into Memory 
S,XXXX,Y1,Y2, Y3, ,YN 



This command substitutes specified 
byte values Yl through YN into memory 
starting at location XXXX. 

Example: 

S 3F00 1,2,4,8,10,20,40,80 

(replaces the contents of memory at 
locations 3F00 through 3F07 with the 
byte value powers of 2) 



Go To User Program and Substitute 
in Trace Mode 

T (XXXX) (B=BBCC) (D=DDEE) 

(H=HHLL) (P=AAFF) 

(S=SSSS) (;YYYY) 



This command functions identically to 
the G command, except that when an RST 
5 instruction is executed, the Monitor 
displays the register contents and 
continues executing user code at the 
next instruction. Note that the semi- 
colon is required when the breakpoint 
option (;YYYY) is selected. 
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Example: 

>T 3CD0,B=0 

(starts execution at 3CD0 with all re- 
gisters set at their prior values, ex- 
cept for registers B and C which are 
both 0) 



any record with an ASCII coded zero in 
the record length field. Examples: 

>W 3001,3005 

:054001002386A10504A7 

:00 



Write Hexadecimal Paper Tape 
W, XXXX, YYYY 



Execute External Utility" 
X, XXXX, (YYYY) 



This command outputs to the TTY the 
contents of memory from locations XXXX 
through YYYY. The output includes tape 
leader preceding the first hex record, 
an end-of-file as the final record, 
and tape leader following the end-of- 
file. 

The formatted tape consists of records 
of ASCII coded hexadecimal bytes. When 
the tape is created, each byte is 
written from memory as two ASCII char- 
acters. The first character is the 
display code for the high order 
digit, and the second character is 
display code for the low order 
digit. For example, the byte 



would be punched out 34is, 35j6. 
Each tape record consists of: 



hex 

the 

hex 

45 16 



1) 
2) 



3) 



4) 
5) 

6) 



a colon ( :) , 

two ASCII coded hex digits 
specifying the number (up to 24) 
of bytes punched from memory, 
four ASCII coded hex digits 
specifying the first memory loca- 
tion written to the record, 
two ASCII coded zeroes, 
the ASCII coded hex for data 
punched out, 

the (2's) complement of the 
checksum of 2), 3), 4), 5). 



The last record of the tape 
end-of-file. The end-of-file 



is 
may 



an 
be 



This command initiates special pro- 
grams external to the Monitor. This 
allows user-designated code to execute 
as an extension of the Monitor, and 
preserves the state of the user code 
outside the Monitor memory area. This 
enables the programmer to run his own 
diagnostic, debug, or other special 
routines as he would a standard Moni- 
tor function. 

The Monitor interface to the external 
routine provides a return address on 
the stack, and then transfer control 
to location XXXX. If the optional 
(YYYY) argument is specified, it is 
decoded as a hex value and stored at 
locations 3C00 and 3C01. 

Example: 

>X 800 

1-4. EXECUTION-MODE INTERFACES 

The Monitor initiates user-mode ex- 
ecution of code in response to either 
the G or T directive (as described 
above). Monitor extended execution 
may also be initiated with an X direc- 
tive (as described above). 

To re-enter the Monitor, user code 
must transfer control to one of the 
Monitor entry points. This usually is 
done by executing one of the RST in- 
structions shown in table 1-2. 
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TABLE 1-2. RST INSTRUCTIONS. 



Entry Point 
(Hex Address) 







10 



18 



20 

28 

30 



Instruc- 
tion 



RST 
RST 1 
RST 2 

*RST 3 



RST 4 
*RST 5 

RST 6 



38 



**RST 7 



OP Codes 
(Hex) 



C7 
CF 
D7 

DF 



E7 
EF 

F7 



FF 



1 



Condition 



System reset 
TTY input 
TTY output 



Temporary 
task break- 
point; only 
executed 
once 

Reserved 

Permanent 
task break- 
point or 
tracepoint 

Service 
routine 
address 
Specifica- 
tion 



Interrupt 



Response 



Monitor re-initialized. 

Character is input to register A. 

Character is output from register 
A. 

Execution of user code is sus- 
pended, register contents and 
code location are displayed, 
Monitor enter command mode. 

Returns with no action. 
Same as for RST 3. 



Monitor recognizes the word fol- 
lowing the RST 6 instruction as 
the starting address of an inter- 
rupt service routine. The service 
routine address is stored for 
use by an RST 7 interrupt and 
the program continues executing 
at the byte following the ad- 
dress word. 

User registers are saved in the 
register save area shown in fig- 
ure 1-1 and the service routine 
whose address was supplied by 
the last RST 6 instruction is 
executed. When the service rou- 
tine completes, control is re- 
turned to the Monitor where the 
registers are restored. Control 
is then returned to the user's 
code. 



*These instructions are used to force traces and breakpoints in user programs. 
The Monitor replaces the instruction at the specified location with the break- 
point RST instruction. When program execution is resumed, the original instruc- 
tion is executed first. 

**Saved registers are not stacked; thus only a single level of interrupt may be 
handled by RST 7. The location of the interrupt service routine must be speci- 
fied prior to using RST 7; use RST 6 to accomplish this. User registers are 
saved in locations 3C04H-3C0FH in the working space. 
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1-5. TTY I/O INTERFACE 



During execution, 
use the Monitor 
tines. 



user code can freely 
character I/O rou- 



When RST 1 is executed, the Monitor 
TTY input routine is initiated. The 
Monitor routine waits for the first 
character input from the TTY and re- 
turns the 7-bit ASCII code in regis- 
ter A. Control-Q (11H) is intercepted 
by the routine and causes automatic 
suspension of any active user-code and 
returns to Monitor command mode. 

When RST 2 is executed, the Monitor 
TTY output routine is initiated. The 



Monitor routine transmits the contents 
of register A to the TTY. If an es- 
cape character is input at this time, 
it will be detected by this routine, 
causing automatic suspension of the 
user task and return of control to the 
Monitor. 



1-6. SAMPLE MONITOR OPERATION 

Figure 1-2 is an example of how Mon- 
itor commands might be used. Charac- 
ters following the > prompt are user 
entered Monitor commands. The results 
of the commands are shown on the line 
or lines following the prompt line. 



>D3D08 
3D08 FO 

>D 3D08 3D 12 

3D08 FO 8E FO 8F FO OF FO OF FO OF FO 

>S#3D08# 1,2*3, 4, FF 

>M3D08*3D0B*3D0E 

>D3D08.3D12 

3D08 01 02 03 04 FF OF 01 02 03 04 FO 

>C 3D08 3D0E 
3D0C FF 3D12 FO 

>F3D08#3D10*0 

>D3D08.3D12 

3D08 00 00 00 00 00 00 00 00 00 04 FO 

>W 3D08*3D42 

: 183D080000000000000000000004F02FFOOFF08FFODFFOAFFOOFF48F12 
: 18302000F0OFE00FE00FE00FF00FF00FB00FFO0F700F700FEO0FF00F17 
: 0B3D3800F00FF00FD00FF00FF0ODF0B7 
: 00 

>R200 

>D«3F08.3F12 

3F08 00 00 00 00 00 00 00 00 00 04 FO 



Figure 1-2. Monitor Example. 
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